home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / boot201.arc / BOOT.TXT < prev    next >
Text File  |  1988-12-26  |  21KB  |  480 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                              BOOT.EXE  Version 2.01
  16.                        Copyright 1988 by Stephen C. Kick
  17.  
  18.  
  19.  
  20.                      *************** DISCLAIMER **************
  21.  
  22.          The author, Stephen C. Kick, makes no warranties expressed or
  23.          implied as to the quality or performance of this program. The
  24.          author will not be held liable for any direct, indirect,
  25.          incidental, or consequential damages resulting from the use of
  26.          this program. Your use of the program constitutes your agreement
  27.          to this disclaimer and your release of the author from any form of
  28.          liability or litigation.
  29.  
  30.                      ******************************************
  31.  
  32.  
  33.  
  34.  
  35.          
  36.  
  37.  
  38.               BOOT.EXE Version 2.01 Copyright 1988 by Stephen Kick
  39.  
  40.  
  41.                              PURPOSE OF BOOT.EXE
  42.  
  43.               The purpose of this program is to ease the process of booting
  44.          the  computer  in  different  configurations.    By  boot  up
  45.          configuration,  I  am  refering  to  way  the "CONFIG.SYS" and
  46.          "AUTOEXEC.BAT" files initialize your computer after a reset has
  47.          occured.   Most  people can  use the  same " CONFIG.SYS"  and
  48.          "AUTOEXEC.BAT" files all of the time.  However, for those of us who
  49.          use several different terminate-and-stay-resident programs (TSRs),
  50.          different DOS interfaces, and large programs requiring lots of
  51.          memory the ability to change the boot up configuration of the
  52.          computer is a must. "BOOT.EXE" has been designed for those people
  53.          who require the ability to change the boot up configuration and
  54.          even those who only need this ability occasionally.
  55.  
  56.               "BOOT.EXE" enables up to a maximum of 255 different boot up
  57.          configurations to be used, by allowing data for "CONFIG.SYS" and
  58.          "AUTOEXEC.BAT" files to be placed in a single text file.  Since the
  59.          data is in a text file, it can be easily edited and managed using
  60.          your favorite text editor.  An additional advantage of this program
  61.          is that you will always have clean copies of your different
  62.          "AUTOEXEC.BAT" and "CONFIG.SYS" files available.
  63.  
  64.               "BOOT.EXE" is not memory resident, requires about 80K to
  65.          run and is a DESQview (C) aware program.  DESQview is a trademark
  66.          of Quarterdeck Office Systems.
  67.  
  68.               "BOOT.EXE" is a shareware program, it is NOT PUBLIC DOMAIN.
  69.          The cost, if you decide to use it, is only $10. This is my first
  70.          venture into selling any of the software I have developed, so I
  71.          thought I would start out small and see the response.  Shareware is
  72.          a great way to obtain and evaluate affordable, quality software
  73.          before you fork out the bucks for it.
  74.  
  75.               An example for building the "AUTOEXEC.BAT" and "CONFIG.SYS"
  76.          files is located in a file named "BOOT.CFG".
  77.  
  78.          
  79.  
  80.  
  81.               BOOT.EXE Version 2.01 Copyright 1988 by Stephen Kick
  82.  
  83.                              HOW BOOT.EXE WORKS
  84.  
  85.  
  86.               "BOOT.EXE" works by parsing a text file for your
  87.          "AUTOEXEC.BAT" and "CONFIG.SYS" data.  This text file must be named
  88.          "BOOT.CFG" and must be located in the root directory of the boot
  89.          up disk. "BOOT.EXE" can be located in any subdirectory you desire
  90.          on the boot up disk.  When "BOOT.EXE" is executed it looks in the
  91.          root directory for the file named "BOOT.CFG".  If a parameter has
  92.          not been entered on the command line then "BOOT.EXE" parses the
  93.          text file to build and display a menu.  Parsing is accomplished by
  94.          searching the text file "BOOT.CFG" for four parsing keys, all of
  95.          which begin with a squiggly parenthesis and a dollar sign "{$".
  96.          The four phrases are "{$Default=", "{$Name=", "{$C}", and "{$A}".
  97.          The "{$Default=" phrase will only appear once in the configuration
  98.          file, and then only in column one of the first line.  The remaining
  99.          three phrases are used with each boot up configuration which you
  100.          define.  It is very important to heed the following note:
  101.  
  102.                  ****************** NOTE: *******************
  103.  
  104.          IF ANY OF THESE THREE PHRASES, "{$NAME=", "{$C}", "{$A}", ARE
  105.          MISSING UNPREDICTABLE RESULTS WILL OCCUR.  EACH CONFIGURATION MUST
  106.          USE ALL THREE PHRASES IN THE CORRECT SEQUENCE FOR "BOOT.EXE" TO
  107.          PROPERLY PARSE AND WRITE YOUR "CONFIG.SYS" AND "AUTOEXEC.BAT"
  108.          FILES.  USE THE "CHECK" OPTION AT THE COMMAND LINE TO VERIFY
  109.          "BOOT.CFG" HAS BEEN SET UP CORRECTLY.
  110.  
  111.                  ****************** NOTE: *******************
  112.  
  113.               "BOOT.EXE" searches for "{$Name=" first.  Once that key
  114.          phrase is detected, the line is parsed for the name of that
  115.          particular configuration and checked to see if it matches the one
  116.          being sought after.   If it is not a match then the program
  117.          continues searcheing until a match is found, or the end of the
  118.          file is reached.  After locating the name of desired configuration,
  119.          the program searches for the "CONFIG.SYS" file data which is
  120.          indicated by the "{$C}".  This means you can have an extended
  121.          description on the lines between "{$Name=" and "{$C}" if you want.
  122.          This area could contain the development date, revision status, and
  123.          a more elaborate description of that particular configuration, or
  124.          clever phrases such as "KILROY WAS HERE" for example.  The point
  125.          being that everything between the lines containing "{$Name=" and
  126.          "{$C}" can contain anything you want.  Nothing will be written to
  127.          the "CONFIG.SYS" file until the "{$C}" is detected.   After
  128.          "BOOT.EXE" detects the "{$C}", it regards everything from the
  129.          line after the "{$C}" , to the line proceeding the "{$A}" as data
  130.          for the "CONFIG.SYS" file. The "AUTOEXEC.BAT" file data is then
  131.          considered to be everything on the line following the "{$A}" to
  132.          the line preceding the next "{$Name=", or until the end of the
  133.          file is encountered.
  134.  
  135.          PLEASE NOTE THAT WHEN DEVELOPING YOUR "BOOT.CFG" FILE, DO NOT
  136.          INCLUDE THE QUOTES, THEY ARE ONLY BEING USED FOR HIGHLIGHTING
  137.          PURPOSES.
  138.  
  139.          
  140.  
  141.  
  142.               BOOT.EXE Version 2.01 Copyright 1988 by Stephen Kick
  143.  
  144.                            RULES FOR BUILDING BOOT.CFG
  145.  
  146.  
  147.           1.  The name of a configuration is prefixed by "{$Name=" and may
  148.               be followed by a description. The parsing key "{$Name=" must
  149.               start in column one.  The name can be twelve (12) characters
  150.               long, up to column 20.  Anything starting at column twenty
  151.               (20) is regarded as part of the description.  The description
  152.               can be up to 60 characters long, any more than this is
  153.               ignored. For maximum menu readability limit names to ten (10)
  154.               characters. The name of a configuration can be anything you
  155.               want EXCEPT "CHECK".  The name "CHECK" is reserved for
  156.               debugging purposes (see USING BOOT.EXE, note #7).
  157.  
  158.           2. A default menu choice may be used by adding the parsing key
  159.              "{$Default=" followed by the name of the configuration you
  160.              want to be the default menu choice.  The parsing key "{$Default"
  161.              must be the **FIRST** line in "BOOT.CFG".  The default is used
  162.              to determine which menu choice is to be highlighted when the
  163.              menu is first displayed.  If the default name is not found or
  164.              no default is specified then the default menu choice will be
  165.              the first configuration found in "BOOT.CFG".
  166.  
  167.           3.  After the first line in the configuration file and before the
  168.               first "{$Name=", any number of lines may be used to keep
  169.               notes or descriptions. If fact you may even include this file
  170.               in that area. Just be sure that none of the lines have
  171.               "{$Default=", "{$Name=", "{$C}", or "{$A}" starting in column
  172.               1 since the program uses these to key on.  You may also
  173.               include information after each "{$Name=" and its
  174.               corresponding "{$C}".
  175.  
  176.         NOTE:  Before you include your life history as part of "BOOT.CFG"
  177.                 it is important to point out the program must read those
  178.                 lines to get to the actual configurations, thus resulting
  179.                 in a decrease in performance.  Therefore, keep the
  180.                 information in these areas short.
  181.  
  182.           4.  The information for the "CONFIG.SYS" files are indicated by
  183.               "{$C}" starting at column one and is followed starting on the
  184.               next line by the "CONFIG.SYS" data.
  185.  
  186.           5.  The information for the "AUTOEXEC.BAT" file is indicated by
  187.               "{$A}" starting at column one and is followed starting on the
  188.               next line by the "AUTOEXEC.BAT" data.
  189.  
  190.           6. The parsing keys "{$Name=", "{$C}" and "{$A}" work as a set.
  191.              Each "{$Name" must have a "{$C}" following it and each "{$C}"
  192.              must have a "{$A}" following it.
  193.  
  194.          
  195.  
  196.  
  197.               BOOT.EXE Version 2.01 Copyright 1988 by Stephen Kick
  198.  
  199.                            RULES FOR BUILDING BOOT.CFG (continued)
  200.  
  201.  
  202.           7.  The general layout of the "BOOT.CFG" file is as follows :
  203.  
  204.                 {$Default= 2   (Must be on FIRST LINE IN BOOT.CFG)
  205.                   Any notes or messages for your self here.
  206.  
  207.               {$Name=BootConfig1  Description
  208.               {$C}
  209.               CONFIG.SYS data
  210.  
  211.               {$A}
  212.               AUTOEXEC.BAT data
  213.  
  214.               {$Name=BootConfig2  Description
  215.               {$C}
  216.               CONFIG.SYS data
  217.  
  218.               {$A}
  219.               AUTOEXEC.BAT data
  220.  
  221.           8.  The program is not case sensitive.
  222.  
  223.           9.  Up to a maximum of 255 configurations can be used.
  224.  
  225.           10. Strings in the "BOOT.CFG" file are limited to 255 characters.
  226.               However the lines using the parsing key "{$Name=" should be
  227.               limited to less than 80 characters, anything past column 80
  228.               will be ignored for these lines.
  229.  
  230.          
  231.  
  232.  
  233.               BOOT.EXE Version 2.01 Copyright 1988 by Stephen Kick
  234.  
  235.  
  236.                               USING BOOT.EXE
  237.  
  238.  
  239.           1.  The BOOT program looks for "BOOT.CFG" in the root directory of
  240.               the default drive.  Therefore if you use multiple drives you
  241.               may want to use the following batch file :
  242.  
  243.                                C:
  244.                                CD\
  245.                                BOOT.EXE
  246.  
  247.           2.  The "AUTOEXEC.BAT" and "CONFIG.SYS" files are written to the
  248.               root directory of the default drive.
  249.  
  250.           3.  The name or number of the desired configuration may be entered
  251.               on the DOS command line.  In this case the menu will not be
  252.               displayed unless the choice is invalid.  The command line is
  253.               not case sensitive.
  254.  
  255.                   Examples :  BOOT 4
  256.                               BOOT Plain
  257.  
  258.           4.  If no choice is entered on the command line a menu is
  259.               displayed showing the the configuration number, name and a
  260.               description of each routine.  To select the desired boot
  261.               configuration simply move to the desired configuration using
  262.               the up and down arrow keys and press enter or enter the
  263.               number on the desired configuration.  The PAGE UP, PAGE DOWN,
  264.               HOME and END keys may also be used to move around in the
  265.               menu.  When the digit of a number is pressed an entry line
  266.               will appear on the bottom of the menu prompting for the
  267.               number.  After typing in the desired number press enter.  The
  268.               ESCAPE key may used to exit the menu without making a choice.
  269.  
  270.           5.  When the menu is displayed the number of desired configuration
  271.               may also be entered. If you press a number and want to go
  272.               back to the menu simply press ESCAPE.
  273.  
  274.           6.  The file "BOOT.CFG" must be located in the root directory.
  275.  
  276.           7.  A debugging option has been added for debugging your
  277.               "BOOT.CFG" file.  When the command :
  278.                                BOOT CHECK
  279.               is entered at the DOS command line, "BOOT.EXE" will scan the
  280.               "BOOT.CFG" file and check to see that all the parsing keys
  281.               are in the correct order and that none are missing. If an
  282.               error is found, then the line number, the line containing the
  283.               error, and an error message will be displayed when the
  284.               program terminates. When the "CHECK" option is used no
  285.               "CONFIG.SYS" or "AUTOEXEC.BAT" files will be written or
  286.               modified. The "CHECK" command line option should be used
  287.               whenever changes have been made to "BOOT.CFG" to ensure
  288.               proper operation of the program.
  289.  
  290.  
  291.  
  292.               BOOT.EXE Version 2.01 Copyright 1988 by Stephen Kick
  293.  
  294.  
  295.                               USING BOOT.EXE (continued)
  296.  
  297.  
  298.           8. "BOOT.EXE" will return the following error codes which can be
  299.               used by the DOS "ERRORLEVEL" command in batch files :
  300.  
  301.                  0 :  No Errors, Program ended normally, CONFIG.SYS and
  302.                       AUTOEXEC.BAT files have been updated.
  303.                  1 :  User pressed escape to exit, nothing was written to
  304.                       disk
  305.                  2 :  Unsupported video mode, nothing was written to disk
  306.                  3 :  Missing in parsing key or parsing key out of order.
  307.                       Some data may have been written to disk.
  308.                       Be sure and check the contents of the "CONFIG.SYS"
  309.                       and "AUTOEXEC.BAT" files before rebooting.
  310.                  4 :  Memory error, nothing was written to disk
  311.                  5 :  Error with "BOOT.CFG" file.  Data may have been written
  312.                      to disk.
  313.                      Be sure and check the contents of the "CONFIG.SYS" and
  314.                      "AUOTEXEC.BAT" files before rebooting.
  315.  
  316.           9.  When adding a boot up configuration to "BOOT.CFG" or
  317.               performing a major modification to a configuration make sure
  318.               that you get the "CONFIG.SYS" and "AUTOEXEC.BAT" files you
  319.               are expecting BEFORE YOU REBOOT. This can be accomplished
  320.               very easily by using the TYPE command at the DOS prompt and
  321.               viewing the contents of the "CONFIG.SYS" and "AUTOEXEC.BAT"
  322.               files.  For example the command :
  323.                      TYPE CONFIG.SYS
  324.                entered at the DOS prompt will display the contents of the
  325.                "CONFIG.SYS" file.  The command :
  326.                       TYPE AUTOEXEC.BAT
  327.                 will display the contents of the "AUTOEXEC.BAT" file. You
  328.                 may also use your favorite text editor to view them. If you
  329.                 don't see what you expect to see then re-edit the
  330.                 "BOOT.CFG" file.
  331.  
  332.          
  333.  
  334.  
  335.               BOOT.EXE Version 2.01 Copyright 1988 by Stephen Kick
  336.  
  337.                                 TRYING OUT BOOT.EXE
  338.  
  339.  
  340.               To to try out this program you may perform the following
  341.               steps:
  342.  
  343.                  1. Copy "BOOT.EXE" and "BOOT.CFG" to the root directory of
  344.                     drive A.
  345.  
  346.                  2. Set drive A as your default drive.
  347.  
  348.                  3. Type "BOOT" at the DOS prompt.
  349.  
  350.                  4. Select a boot up configuration from the menu and press
  351.                     ENTER.  The program will then write an "CONFIG.SYS" and
  352.                     "AUTOEXEC.BAT" file to the root directory on drive A.
  353.  
  354.                  5. At the DOS prompt type "TYPE CONFIG.SYS" to view the
  355.                     contents of the "CONFIG.SYS" file.
  356.  
  357.                  6.  At the DOS prompt type "TYPE AUTOEXEC.BAT" to view the
  358.                      contents of the "AUTOEXEC.BAT" file.
  359.  
  360.          
  361.  
  362.  
  363.               BOOT.EXE Version 2.01 Copyright 1988 by Stephen Kick
  364.  
  365.                             HISTORY OF BOOT.EXE
  366.  
  367.  
  368.               BOOT.EXE was conceived when I was attempting to automate
  369.          the selection of different AUTOEXEC.BAT and CONFIG.SYS files in
  370.          order to boot up my computer in different configurations.  I manage
  371.          about ten different computers , all with different software and
  372.          hardware configurations, therefore, I needed a system which was
  373.          easy to maintain and adaptable.  I initially tried to implement the
  374.          system using numerous batch files, however I could never remember
  375.          exactly which one did what and had numerous files to edit and
  376.          keep track of.  Next I tried to combine everything into a single
  377.          elaborate batch file.  This was easier to use but cumbersome to
  378.          manage.
  379.  
  380.               I finally decided to use a program to parse the different
  381.          "AUTOEXEC.BAT" and "CONFIG.SYS" files out of a single text file.
  382.          Version 1 of "BOOT.EXE" used the first 25 lines in the text file
  383.          to display the menu.  Actually, it wasn't really a menu, if nothing
  384.          was entered on the command line then the first 25 lines of the
  385.          text file were displayed as a menu.  Version 1 was very compact,
  386.          taking up less than 3K of executable code and less than 20K of
  387.          memory to run.  Version 1 worked great, except that it was a chore
  388.          to modify.  Every time a boot up configuration was added, or
  389.          deleted, the menu had to be changed manually. Version 2 entirely
  390.          automates the building of a real menu.  Implementation of the menu
  391.          system required almost an entire rewrite of the system and
  392.          resulted in a much larger program. The result, however is an
  393.          extremely easy method of managing multiple boot up configurations
  394.          for your computer.
  395.  
  396.                Version 2.01 added some finishing touches to Version 2.00.
  397.          The 2.00 version used a number as an entry for the default menu
  398.          choice.  Version 2.01 allows a name to be specified instead.  This
  399.          is much easier than trying to count down to the configuration
  400.          which you want to use for the default. Additional error checking
  401.          has also been added to Version 2.01 via the "CHECK" option which
  402.          can be entered at the command line. The "CHECK" option will scan
  403.          the "BOOT.CFG" file for errors.
  404.  
  405.          
  406.  
  407.  
  408.               BOOT.EXE Version 2.01 Copyright 1988 by Stephen Kick
  409.  
  410.                            BOOT.EXE Registration
  411.  
  412.  
  413.               BOOT.EXE can be registered for only $10. Please fill out the
  414.          information below and return with your Check, Money order, or Cash
  415.          (sorry no credit cards) to :
  416.  
  417.                                  Stephen C. Kick
  418.                                  703 Alder Drive
  419.                                  Allen, Texas 75002
  420.  
  421.  
  422.           I can also be contacted on :
  423.  
  424.                      BIX :  SKICK
  425.            or CompuServe :  73707,2340
  426.  
  427.           if you have any further questions.
  428.  
  429.          
  430.  
  431.  
  432.               BOOT.EXE Version 2.01 Copyright 1988 by Stephen Kick
  433.  
  434.  
  435.                            BOOT.EXE Registration Form
  436.  
  437.  
  438.          Mail this registration form to :
  439.  
  440.                                  Stephen C. Kick
  441.                                  703 Alder Drive
  442.                                  Allen, Texas 75002
  443.  
  444.  
  445. Name : _____________________________________
  446.  
  447. Company : __________________________________
  448.  
  449. Address : ___________________________________
  450.  
  451. City : __________________________     State : _________   Zip Code : __________
  452.  
  453. Phone Number :  ________________
  454.  
  455. Number of copies of "BOOT.EXE"  _____________ X $10 =  ___________  Total
  456.  
  457. How and where did you obtain program :  ______________________________________
  458.  
  459. ______________________________________________________________________________
  460.  
  461. Type of Computer :   ___________________________________
  462.  
  463. Primary use of Computer :  _______________________________________
  464.  
  465. Peripherals Used :  __________________________________________________________
  466.  
  467. ______________________________________________________________________________
  468.  
  469. ______________________________________________________________________________
  470.  
  471. Comments :  __________________________________________________________________
  472.  
  473. ______________________________________________________________________________
  474.  
  475. ______________________________________________________________________________
  476.  
  477. ______________________________________________________________________________
  478.  
  479.          
  480.